Document breaking change: dotnet CLI commands log non-command-relevant data to stderr #48924
+71
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR documents the breaking change introduced in .NET 10 RC 2 where
dotnet
CLI commands now emit non-command-relevant data (such as first-run messages) tostderr
instead ofstdout
. This change addresses the requirement to keepstdout
clean for parsing and interpretation in scripting and noninteractive scenarios.Changes
New Documentation
docs/core/compatibility/sdk/10.0/dotnet-cli-stderr-output.md
: Comprehensive breaking change document that includes:$Error
)DOTNET_NOLOGO
to disable messagesUpdated Documentation
docs/core/compatibility/10.0.md
: Added entry to SDK and MSBuild section tabledocs/core/compatibility/toc.yml
: Added TOC entry for navigationdocs/core/tools/telemetry.md
: Added NOTE in the Disclosure section explaining the stderr behavior change with cross-reference to the breaking change documentContext
Starting with .NET 10 RC 2 (SDK PR #50472), the .NET CLI has been improved to separate command output from informational messages. Currently, this affects first-run messages, but the set of messages emitted to stderr will grow over time as the SDK evolves.
This change improves the developer experience by:
stdout
for piping and parsing in scriptsFixes https://dev.azure.com/msft-skilling/Content/_workitems/edit/494515
Original prompt
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.